.. _cmsIxArc3PTo:

cmsIxArc3PTo
================================
--------------------------------


SYNOPSYS
`````````````
.. code-block:: none

    VT_I4 cmsIxArc3PTo([in] VT_I4 BoardID, [in] VT_I4 MapIndex, [in] VT_R8 P2[],
    [in] VT_R8 P3[], [in] VT_R8 EndAngle, [in] VT_I4 IsBlocking)        

DESCRIPTION
`````````````  

- 현재 절대(絶對)적 좌표와 두 개의 매개변수로 지원되는 좌표를 통하여 원호보간이동을 
  수행합니다. cmsIxArc3PTo() 함수는 모션이 완료되기 전까지 반환되지 않으며, 
  cmsIxArc3PToStart() 함수는 모션을 시작시킨 후에 바로 반환됩니다.   

\

- 원호보간은 현재 절대(絶對)적 좌표와 임의의 두 좌표에 대해서 적용됩니다. 세 점을 통해 
  만들어지는 원에서 매개변수로 주어지는 각의 값만큼 보간 이송을 합니다. 

\

- 이 함수의 사용과 호출에 있어, 제공된 ㈜커미조아의 함수 헤더 Visual Basic 에서는 함수의
  첨두어 cms 가 붙지 않습니다.


PARAMETER
`````````````

▶ BoardId: 사용자가 설정한 디바이스(보드) ID. 
 
▶ MapIndex : 맵번호(Map index), 이 맵번호를 사용하기전에 먼저 cmsIxMapAxes() 함수를 
통하여 해당 맵번호에 유효한 축들이 맵핑되어 있어야 합니다. 
 
▶ P2[] : 두번째 좌표배열입니다. 
 
▶ P3[] : 세번째 좌표배열입니다. 
 
▶ EndAngle: 현재 좌표에서 원하는 위치까지의 각도를 나타냅니다. 현재 좌표에서 세 점을 
통해 만들어지는 원위를 이 파라미터 값만큼 보간이송합니다. 

▶ IsBlocking : 완료될 때까지 기다리는 동안 윈도우 메시지를 블록(Blocking)할 것인지를 
결정합니다.  

  .. csv-table::
   :widths: 10 90
   :header-rows: 1
   :stub-columns: 0

    Value, Meaning
    "| 0 또는 cmsFALSE", "
     |                     블록(Blocking)을 하지 않습니다. 따라서 해당 모션이 
     |                     완료되는 동안에도 윈도우 이벤트를 처리합니다."
    "| 1 또는 cmsTRUE","
     |                  블록(Blocking)을 합니다. 따라서 해당 모션이 완료되는 
     |                  동안에는 윈도우 이벤트가 처리되지 않습니다."        


RETURN VALUE
`````````````

+------------+-----------+
|    Value   | Meaning   |
+============+===========+
|    음수    | 수행 실패 |
+------------+-----------+
| ERR_NONE   | 수행 성공 |
+------------+-----------+

REFERENCE
```````````````

- cmsIxArc3PToStart() 함수를 사용하는 경우에는 cmsIxIsDone() 함수나 cmsIxWaitDone() 
  함수를 사용하여 모션의 완료를 확인(確認)할 수 있습니다.  

\

- cmsIxArc3PTo() 함수를 사용하는 경우에는 내부적으로 루프를 수행하면서 모션이 
  완료되기를 기다리는데, 이때 “Blocking Mode”설정에 따라 윈도우 이벤트를 처리하는 방식이 
  달라집니다.  그러나 일반적으로 윈도우의 작업 쓰레드(Work Thread) 에서는 블록모드를 
  사용하여, 함수내부에서 지연없이 쓰레드 내부의 작업에 집중할 수 있도록 설정하는 것이 
  바람직합니다. 

\

- cmsIxArc3PTo() 함수를 사용하는 경우에는 INP 입력신호가 Enable로 설정되었으면 
  Command 펄스 출력이 완료되어도 INP 입력이 ON이 되기 전까지는 모션이 완료되지 않은 
  것으로 간주되어 반환되지 않습니다.   

.. note:: "윈도우 이벤트라는 것은 무엇입니까?"
    윈도우 운영체제는 Event Driven 혹은 Message Driven 방식1의 구조로 
    되어 있습니다. 각 응용프로그램은 메시지 큐(Queue)를 가지고 있으며, 
    정확히 말하면, 메시지를 사용해 이벤트를 통지하는 방식으로 설계되어 
    있습니다. 윈도우 메시지를 처리한다는 것은 메시지 큐에서 메시지를 
    하나씩 꺼내서 윈도우 프로시저에 전송한다는 것을 의미하며, 이것은 그 
    행선지가 되는 윈도우에 전송되어 처리됩니다.